home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / rbbs_pc / rbbsdocs.zip / RBBSDOCS.1 next >
Text File  |  1990-11-05  |  15KB  |  271 lines
  1.  
  2.  
  3.  
  4.     INTRODUCTION                                                            1-1
  5.  
  6.  
  7.     1. INTRODUCTION
  8.     ---------------
  9.     RBBS-PC is  a Remote Bulletin Board  System for the  IBM personal computer,
  10.     hence  the name  RBBS-PC.    RBBS-PC's  primary  application  is  a  "host"
  11.     communications package.  This allows a System Operator (SysOp) to control a
  12.     system that lets "remote" callers use the host computer for many functions,
  13.     including:
  14.  
  15.          - the dissemination of news and bulletins
  16.          - electronic mail between users
  17.          - exchange of programs and data
  18.          - taking surveys and placing on-line purchase orders
  19.          - or playing games.
  20.  
  21.     RBBS-PC is a "full featured" bulletin board system that not only supports a
  22.     broad  range  of  functions,  but  runs  "multi-user"  under  networks  and
  23.     multi-taskers.  RBBS-PC can also run as a "local" application  in which the
  24.     "user" does not connect  through a telephone line, such as  on a local area
  25.     network.
  26.  
  27.     1.1 The Philosophy Behind RBBS-PC
  28.     ---------------------------------
  29.     RBBS-PC  is  given  away  freely,  with  source  code.    Its  authors  and
  30.     contributors neither ask for nor receive any money for their work.  RBBS-PC
  31.     is "Userware", meaning that it  is supported and enhanced by  the community
  32.     of people using it, who believe that  what is shared becomes better than it
  33.     was.   It is hoped  that RBBS-PC will  be used as  a catalyst for  the free
  34.     exchange  of   information,  an   educational  example  of   communications
  35.     programming,  and an irrepressible political  force that puts  the power of
  36.     information in the hands of the many.
  37.  
  38.     1.2 Distribution of RBBS-PC
  39.     ---------------------------
  40.     Each  new version  of  RBBS-PC is  initially sent  to the  CPCUG's Software
  41.     Exchange  for distribution.  CPCUG  is a Maryland  Corporation whose "legal
  42.     name"  is the Capital PC  User Group, Inc.   The CPCUG is an all-volunteer,
  43.     non-profit  organization according  to  Section 501C3,  Social Welfare,  of
  44.     federal law.   All revenues are  re-invested in and applied  toward CPCUG's
  45.     education programs.
  46.  
  47.     There is no fee at  all for using or distributing RBBS-PC.   Indeed, no one
  48.     can charge for its use or  distribution, though user groups and  commercial
  49.     distributors  of software can recover  their costs but  not charge anything
  50.     for RBBS-PC itself.
  51.  
  52.     RBBS-PC can also be downloaded from hundreds of bulletin boards across  the
  53.     country.  If the BBS  you are calling is running RBBS-PC,  chances are good
  54.     they will also have the files in their library.
  55.  
  56.     1.3 The "Contributions" Requested for RBBS-PC
  57.     ---------------------------------------------
  58.     RBBS-PC  lives and  dies by  the unremunerated  contributions of  it's user
  59.     community.  Four types of "contributions" are requested for RBBS-PC:
  60.  
  61.          A.  Modifications   to  RBBS-PC,  itself,  that   are  documented  and
  62.          distributed  as .MRG  files against the  "base-line" source  code that
  63.          other SysOps might elect to incorporate into their version of RBBS-PC.
  64.          Remember  that RBBS-PC can be  distributed in modified  form only with
  65.          permission.   Distributing  a modified  EXE (executable)  file without
  66.  
  67.  
  68.  
  69.     RBBS-PC 17.3A            TECHNICAL REFERENCE MANUAL                     1-2
  70.  
  71.  
  72.          permission violates both the RBBS-PC copyright and the limited license
  73.          granted with it's use.
  74.  
  75.          B.  Publicly distributable software.  It can either be "public domain"
  76.          (i.e.  software which the author has relinquished all rights and which
  77.          may be  appropriated  by anyone  for  use  in any  way),  or  publicly
  78.          distributable software (i.e. software in which the author has retained
  79.          the  rights and  which may  only be used  according to  the conditions
  80.          under which the author has designated).
  81.  
  82.          C. Equipment or  services.   If you  or your  organization can  donate
  83.          equipment,  software, supplies,  or  services to  support the  RBBS-PC
  84.          development effort,  feel free to do  so.  Contact any  of the authors
  85.          (listed on the  title page of  this document) if  you wish to  discuss
  86.          equipment donations.
  87.  
  88.          D.  Money  - the  last  level of  "contribution".   Money  is  the one
  89.          commodity  that  we  are  willing to  exchange  without  first  having
  90.          obtained the  respect or  consideration of  the  other party.   It  is
  91.          perhaps the easiest to give as it exonerates us from  the other levels
  92.          of "contribution."  RBBS-PC development is an all volunteer effort, so
  93.          money is never  plentiful.   However, when equipment  donation is  not
  94.          possible,  spare cash can often buy  a piece of hardware that requires
  95.          experimentation before RBBS-PC can support it.  Remember, money is not
  96.          the  best or  even the  second-best type  of "contribution"  you could
  97.          make.
  98.  
  99.     Independent  of   any  donations  of  enhancements   to  RBBS-PC,  publicly
  100.     distributable software,  equipment,  services, supplies,  or money,  please
  101.     consider becoming a  member of CPCUG.  Simply send  your name, address, and
  102.     phone  number along with  $35 to CPCUG,  51 Monroe Street,  Plaza East Two,
  103.     Rockville, MD 20850 or call their membership hot line at (301) 670-1737.
  104.  
  105.     If in the final analysis you feel that you can do none of the above,
  106.  
  107.          - remember those who have,
  108.          - enjoy what they have nurtured, and
  109.          - keep the faith with those who have gone before you.
  110.  
  111.     RBBS-PC  is what it  is today only  because of the  freely donated time and
  112.     work  of  many  contributors.   Contributions  have  included  suggestions,
  113.     software  fixes,  significant  enhancements,  improved  documentation,  and
  114.     utilities.    Some  of the  individuals  named  here  have continued  their
  115.     contributions to RBBS-PC even to the current release.  Others  have gone on
  116.     to  pursue different interests.  But  whether mentioned below or not, their
  117.     contributions  live on  in RBBS-PC.   In  their contributions  to RBBS-PC's
  118.     on-going growth,  each has  paused to  give of themselves  without hope  of
  119.     reward  by practicing  RBBS-PC's  fundamental principle  -- "users  helping
  120.     users."
  121.  
  122.  
  123.  
  124.     INTRODUCTION                                                            1-3
  125.  
  126.  
  127.     While  we have  met very  few of  these people  personally, those  names we
  128.     remember are:
  129.  
  130.     Doug Azzarito              Ray Horton                Harvey Pierce
  131.     Jeff Batdorf               Gary Howrith              Danny Plunkette
  132.     Rod Bowman                 Charlie Innusa            Lee Pollard
  133.     Matthew Briggs             Loren Jones               Jeff Porter
  134.     Randy Brodersen            Larry Jordan              James Reinder
  135.     Mike Brown                 Robert Jueneman           Joel Ricketts
  136.     Sam Brown                  Vern Kallegin             Kurt Riegel
  137.     Mike Button                Dave Kleinschmidt         Jacques Rodrique
  138.     Vince Castelli             Steven Kling              Dick Rohradnz
  139.     Rob Cecchino               Kim Kodde                 Rich Schinnell
  140.     Tom Collins                Blaine Korcel             Mark Seiden
  141.     Drew Commins               Ronald Koridon            Rosemarie Siddiqui
  142.     Ezra Conger                John Krytus               Andrew Silber
  143.     Ed Copley                  Mark Lautenschlager       Carl Slaughter
  144.     Richard Couture            Steve Lieber              Samuel H. Smith
  145.     Bob Cramer                 Steven Linhart            Gregg Snyder
  146.     Dave Crane                 Joseph Lionelle           Robert Snyder
  147.     Daryl Damon                Scott Loftesness          Carl Spencer
  148.     Everett Delano             Harry Logan               David Staehlin
  149.     Francis Dorer              Gene Lowry                Stan Staten
  150.     Peter Eibl                 James Ludwick             Terry Steichen
  151.     Warren Fox                 Kevin Lutz                Dorn Stickle
  152.     John Friel                 D. Thomas Mack            Randy Sun
  153.     Jim Fry                    Robert Mahoney            Terry Taylor
  154.     Asa Fulton                 Matt Malden               Jan Terpstra
  155.     Kent Galbraith             Carl Margolis             Arnold Thomsen
  156.     Mitch Geier                Sidney Markowitz          Daan van der Weide
  157.     John German                Jon Martin                Rick Wadowski
  158.     Read Gilgen                Louie McCaw               Clark Walker
  159.     Ken Goosens                Wes Meier                 Kim Wells
  160.     Ray Gwinn                  John Morris               Bob Westcott
  161.     Dave Hacquebord            Bill Newkirk              Robert White
  162.     Steve Harrison             Jeregen Nordhausen        Yew Seng Tan
  163.     Gary Hoff                  Vince Perriello
  164.  
  165.     Special thanks goes to  SysOps who helped sponsor enhancements  to RBBS-PC,
  166.     including Ken Rogers of  the United States Department of  Commerce ECONOMIC
  167.     BULLETIN   BOARD   who    encouraged   configurable   identification    and
  168.     individuation, Loren  Jones of  The Center  for Law  and  Computers at  the
  169.     Illinois  Institute  of  Technology's   Chicago-Kent  College  of  Law  who
  170.     contributed to subscription  support, John Rittwage of the American College
  171.     of  Obstetricians and  Gynecologists who  helped support  submenus and  the
  172.     programmable user interface, and Brian Kelly of  National Credit Appraisals
  173.     and  Reporting, whose  special needs prompted  the development  of personal
  174.     downloading.
  175.  
  176.     To  those whose names  have not been  mentioned --  apologies are extended.
  177.     Take comfort in knowing that you live on in the work that you have wrought.
  178.  
  179.     In an  age of  cynicism, RBBS-PC  and the  Userware  concept represents  an
  180.     opportunity for  each of us to  give back to  the world something  a little
  181.     better than when we found it, and is something  that the authors of RBBS-PC
  182.     believe in strongly.  To each of the contributors to RBBS-PC, we would like
  183.     to say personally, "We are very proud of the company that RBBS-PC keeps."
  184.  
  185.  
  186.  
  187.     RBBS-PC 17.3A            TECHNICAL REFERENCE MANUAL                     1-4
  188.  
  189.  
  190.     1.4 How to Send Improvements
  191.     ----------------------------
  192.     RBBS-PC  continues to  evolve  and be  "debugged."   The  following  coding
  193.     conventions have  been helpful in the past and you are requested to observe
  194.     them in the future:
  195.  
  196.     Updates consist of  two types of ASCII  files.  One called *.MRG  which are
  197.     the BASIC  source  statements  for the  particular  base-line  source  code
  198.     component of RBBS-PC to be updated.  The lines that have been modified  are
  199.     indicated as being so modified with a comment beginning in column 70 in the
  200.     format as follows:
  201.  
  202.     4330 CALL QuickTPut("This line has been changed!",1)          ' DA091402
  203.  
  204.     The comment in column 70 consists  of the changer's initials, the month and
  205.     day of the change, and a sequence number.  Thus, the comment DA091402 means
  206.     Doug Azzarito made this  change on Sept 14th, and it was  the second change
  207.     he made that day.
  208.  
  209.     These .MRG  files can  be  applied to  the base-line  source  code via  Ken
  210.     Goosens' Batch  Line EDitor utility program  (BLED).  The BLED  utility can
  211.     easily  create .MRG  files as  it has both  a file  compare and  file merge
  212.     function  that  is  specifically   geared  to  the  new   BASIC  compiler's
  213.     capabilities that allow lines of source to be unnumbered.
  214.  
  215.     The second file type is called *.DOC.  It describes on a line-by-line basis
  216.     the  specific functions added or bug that was fixed.  The .DOC file is what
  217.     allows  us to integrate several  .MRG files and  resolve whatever conflicts
  218.     that may exist.
  219.  
  220.     Each incremental release of RBBS-PC beyond 17.3 will include updates to the
  221.     base-line documentation.  When possible, these  updates will be in the form
  222.     of replacement pages to be inserted in the baseline documentation.
  223.  
  224.     The RBBS-PC naming conventions of 99.9X are roughly as follows:
  225.  
  226.     1.  If a significant change to  source code or logic  occurs, the first two
  227.     digits of  the release level will change (i.e. 14.1 was followed by  15.1).
  228.     Such  changes usually  include  system  file  format  changes  requiring  a
  229.     "reconfiguration."
  230.  
  231.     2.   If  a new  feature or  enhancement is  added the  digit following  the
  232.     decimal point  is incremented  by one  (i.e. 17.2B  was followed  by 17.3).
  233.     These changes usually do NOT require "reconfiguration."
  234.  
  235.     3.  If a "bug" is being fixed, the letter at the end of the version  number
  236.     is incremented (i.e.  17.2A was  followed by 17.2B).   These  "maintenance"
  237.     releases  contain no  new significant  features, but often  fix troublesome
  238.     bugs in the previous version.   With each maintenance release, a  .MRG file
  239.     name such as 17-3A.MRG and a corresponding 17-3A.DOC file will describe the
  240.     changes.  The first maintenance version is always "A".
  241.  
  242.     4.  As bugs  are reported and fixes found for the  current release of RBBS-
  243.     PC, the source code  corrections are distributed via an  RFIXmmdd.ZIP file.
  244.     This  contains the necessary files  to apply the  "temporary fixes" against
  245.     the released  version of the  source code and  re-compile the  source code.
  246.     The recompiled .EXE files are distributed via a file named RFIX-EXE.ZIP.
  247.  
  248.  
  249.  
  250.     INTRODUCTION                                                            1-5
  251.  
  252.  
  253.     The purpose of these conventions is to allow everyone to know what  RBBS-PC
  254.     level   they  are  running  under  and  understand  the  logic  behind  the
  255.     changes/fixes as  they occur so  each SysOp can  evaluate them for  his own
  256.     needs.  When you logon to RBBS-PC the version will be displayed.
  257.  
  258.     If you have  comments or  fixes, please  let us know  so that  they can  be
  259.     reflected in the  RBBS-PC program and shared with all other users.  You can
  260.     do that by sending your changes by mail to:
  261.  
  262.                                     Ken Goosens
  263.                                 5020 Portsmouth Road
  264.                               Fairfax, Virginia 22032
  265.  
  266.     or uploading the changes to Ken Goosens' BBS at 703-978-6360.
  267.  
  268.     All comments  and suggestions  are welcome,  but those  that are  come with
  269.     source code changes carry more weight.
  270.  
  271.